package com.empire.module.member.service.location;

import com.empire.module.member.controller.admin.location.dto.FrequentLocationDTO;
import com.empire.module.member.controller.admin.location.vo.*;
import com.empire.module.member.dal.dataobject.location.LocationDO;
import com.empire.framework.common.pojo.PageResult;

import javax.validation.Valid;
import java.util.List;

/**
 * 定位信息 Service 接口
 *
 * @author 主席大人
 */
public interface LocationService {

    /**
     * 创建定位信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createLocation(@Valid LocationSaveReqVO createReqVO);

    /**
     * 更新定位信息
     *
     * @param updateReqVO 更新信息
     */
    void updateLocation(@Valid LocationSaveReqVO updateReqVO);

    /**
     * 删除定位信息
     *
     * @param id 编号
     */
    void deleteLocation(Long id);

    /**
     * 获得定位信息
     *
     * @param id 编号
     * @return 定位信息
     */
    LocationDO getLocation(Long id);

    /**
     * 获得定位信息分页
     *
     * @param pageReqVO 分页查询
     * @return 定位信息分页
     */
    PageResult<LocationDO> getLocationPage(LocationPageReqVO pageReqVO);

    /**
     * 查询指定人员的常去地统计
     *
     * @param personId 人员ID
     * @return 常去地列表（按出现次数降序，默认返回10条）
     */
    List<FrequentLocationDTO> getFrequentLocations(Long personId);

    /**
     * 查询指定人员的常去地统计（支持自定义返回条数）
     *
     * @param personId 人员ID
     * @param limit    返回条数限制
     * @return 常去地列表
     */
    List<FrequentLocationDTO> getFrequentLocations(Long personId, Integer limit);


}